package com.ruoyi.system.service;

import java.util.List;
import java.util.Map;
import com.ruoyi.system.domain.GuangDianUser;

/**
 * 广电用户Service接口
 * 
 * @author ruoyi
 * @date 2024-01-18
 */
public interface IGuangDianUserService
{
    /**
     * 查询广电用户
     * 
     * @param id 广电用户主键
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserById(Long id);

    /**
     * 根据用户编号查询广电用户
     * 
     * @param phoneNo 用户编号
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserByPhoneNo(String phoneNo);

    /**
     * 根据地址编号查询广电用户
     * 
     * @param terminalNo 地址编号
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserByTerminalNo(String terminalNo);

    /**
     * 查询广电用户列表
     * 
     * @param guangDianUser 广电用户
     * @return 广电用户集合
     */
    public List<GuangDianUser> selectGuangDianUserList(GuangDianUser guangDianUser);

    /**
     * 新增广电用户
     * 
     * @param guangDianUser 广电用户
     * @return 结果
     */
    public int insertGuangDianUser(GuangDianUser guangDianUser);

    /**
     * 批量新增广电用户
     * 
     * @param guangDianUserList 广电用户集合
     * @return 结果
     */
    public int batchInsertGuangDianUser(List<GuangDianUser> guangDianUserList);

    /**
     * 修改广电用户
     * 
     * @param guangDianUser 广电用户
     * @return 结果
     */
    public int updateGuangDianUser(GuangDianUser guangDianUser);
    
    /**
     * 从CSV文件导入广电用户数据
     * 
     * @param filePath CSV文件路径
     * @param limit 导入记录限制，0表示无限制
     * @return 导入的记录数
     */
    public int importFromCsv(String filePath, Integer limit);
    
    /**
     * 查询最近的用户数据
     * 
     * @param limit 返回记录数量
     * @return 最近用户数据列表
     */
    public List<GuangDianUser> findRecentData(Integer limit);

    /**
     * 批量删除广电用户
     * 
     * @param ids 需要删除的广电用户主键集合
     * @return 结果
     */
    public int deleteGuangDianUserByIds(Long[] ids);

    /**
     * 删除广电用户信息
     * 
     * @param id 广电用户主键
     * @return 结果
     */
    public int deleteGuangDianUserById(Long id);

    /**
     * 统计广电用户数量
     * 
     * @param guangDianUser 广电用户条件
     * @return 数量
     */
    public int countGuangDianUser(GuangDianUser guangDianUser);

    /**
     * 根据标签字段和值统计用户数量
     * 
     * @param tagField 标签字段名
     * @param tagValue 标签值
     * @return 数量
     */
    public int countUserByTag(String tagField, String tagValue);
    
    /**
     * 获取用户总数
     * 
     * @return 用户总数
     */
    public long count();
    
    /**
     * 根据标签统计用户数量
     * 
     * @param tagField 标签字段名
     * @param tagValue 标签值
     * @return 符合条件的用户数量
     */
    public long countByTag(String tagField, String tagValue);
    
    /**
     * 获取仪表盘统计数据
     * 
     * @return 统计数据Map
     */
    public Map<String, Object> getDashboardStats();
    
    /**
     * 查询最近更新的数据
     * 
     * @param limit 查询数量
     * @return 最近更新的数据列表
     */
    public List<GuangDianUser> findRecentData(int limit);
    
    /**
     * 导入用户数据
     * 
     * @param file Excel文件
     * @param updateSupport 是否更新支持，如果已存在，则进行更新数据
     * @return 结果
     */
    public String importGuangDianUser(MultipartFile file, boolean updateSupport);

    /**
     * 查询最近的广电用户数据
     * 
     * @param limit 限制数量
     * @return 广电用户集合
     */
    public List<GuangDianUser> selectRecentGuangDianUsers(int limit);

    /**
     * 从CSV文件导入广电用户数据
     * 
     * @param filePath CSV文件路径
     * @param limit 导入数量限制
     * @return 导入数量
     */
    public int importGuangDianUserFromCsv(String filePath, int limit);
}